Shareware Super Platinum 8/Shareware Super Platinum 8.iso/mac/MODEMPRO/ZOC132.ZIP;1/ZOC/ZOC.HLP

OS/2 Help File | 1994-05-25 | 69.0 KB | 2,067 lines

‚ïê‚ïê‚ïê 1. Looking for help? ‚ïê‚ïê‚ïê

                      ZOC is a shareware terminal package.
                             Share it if you use it

Good places to start looking for help

o Take a look at the  Menu Overview

o Looking at the  Screen Elements can make things a lot easier.

o Or just press Ctrl+C to see the contents of this helpfile.


‚ïê‚ïê‚ïê 2. Starting ZOC (command line parameters) ‚ïê‚ïê‚ïê

There are some parameters, that can be specified when starting ZOC from the
commandline or from an icon.

ZOC [/C] [/CP:<codepage>] [/H:<height>] [/M] [/S:<scriptfile>] [/U]
[/W:<width>] [COMx]

     /C
    This option specifies that you want ZOC to open the com port in shared
    (cooperative) mode.

     /CP
    This option specifies an alternate codepage for the terminal window.
    Normally codepage 437 is used.

     /H
    The /H option sets the terminal window to a given height (in characters).

     /M
    This option specifies that you want to start ZOC minimized.

     /U
    This option specifies unattended mode. In unattended mode ZOC will not show
    requesters. Instead it uses the default action of these. So ZOC will not
    hang and wait for an answer if you start it at 3.00AM to automatically
    collect your messages.

     /S
    With this option, you can tell ZOC to process a scriptfile when start. A
    path can be specified, e. g. 'ZOC /S:SCRIPT\NIGHTCALL'

     /W
    The /W option sets the terminal window to a given widht (in characters).

     COMx
    This option tells ZOC which com port to use. If not specified, ZOC searches
    for the ZOCDEVICE environment variable to determine the com port.


‚ïê‚ïê‚ïê 3. Registration information ‚ïê‚ïê‚ïê

                      ZOC is a shareware terminal package.
                           (C) by Markus Schmidt 1994

                               Please read this!!!

                   Orders, Registration Sites, Pricing, Payment
                       Registered vs. unregistered version
                              Contacting the author


‚ïê‚ïê‚ïê 3.1. Read this first ‚ïê‚ïê‚ïê

This window is not a nuisance feature. It can be turned off via the  Window
Options dialog. Then just save options as '.\OPTIONS\STANDARD' and you will
never see this window again.

But: Before turning it off, *PLEASE* read the help topics presented here. Just
today I received a three page FAX asking questions, half of which are answered
here or in README.DOC (the other window that pops up when you start a new ZOC
version).

Don't get me wrong: If you don't find the solution to your problem in the docs,
you're welcome to  contact me.

If you encounter problems please check the common problems section (in the help
menu) first.

If you want to register, select Order From from the Help menu. Please read the
section about  pricing and payment first.

If you need a German version it is available from the ZOC support bbs described
in  availability.

You need not play around with the icons of the toolbar. They are described in
help for toolbar and you can get a quick description for each icon if you click
it with the right mouse button.


‚ïê‚ïê‚ïê 3.2. Contacting the author ‚ïê‚ïê‚ïê

I don't monitor international conferences or forums. If you have problems,
please contact me personally. Preferred ways to contact me (checked almost
daily):

     Internet
    [e-mail]

    Please don't post big files (>5K) without my consent. I have to pay for
    incoming internet mail and I don't want to pay another $450 for internet
    mail (as in Dec, 1993), if I can avoid it.

     Compuserve
    100101,3256

 ZOC Infobbs
    The number is [phone] (or 0911 9933662 from Germany). Login as
    'ZOC'.

 Zerberus Net
    [e-mail]

Postal ways:

     Phone/FAX
    +49+911+7499380 (or 0911 7499380 from within Germany). This is a hybrid
    voice/FAX answering machine, that will recognize incoming FAXes (If you
    encounter problems sending your FAX to this number, try again and if you
    have no success, send the FAX to +49+911+3193618).

 Mail

        Markus Schmidt
        Waagstr. 4
        90762 Fuerth
        - Germany -


‚ïê‚ïê‚ïê 3.3. Orders, Registration Sites, Pricing, Payment ‚ïê‚ïê‚ïê

 Orders

    If you are living in North America or Australia see below for registration
    sites in your country.

    The most convenient way to order is to logon to Compuserve, type 'GO SWREG'
    at the 'forum!' prompt, search for 'ZOC' and register online. This will get
    you a 'future license' and the price is charged with your next Compuserve
    bill.

    If you don't want to order via Compuserve (or if you don't have an account
    there, select 'Order Form' from the help menu and enter your personal data,
    method of payment (see below). and type of license. Then print or file the
    order form. ZOC will compute the price (see below) automatically and print
    (or file) it with the order form.

    In return to your order you receive a letter (and probably email/fax) that
    contains a license, information on how to remove the display of the order
    form after each download, a disk label and - if you ordered one - a disk
    with the current version of ZOC and ZOC related files (like ZOCDEV.ZIP,
    ZOCBK.ZIP).

 Registration Sites

    Germany

                                     Markus Schmidt
                                       Waagstr. 4
                                      90762 Fuerth

                                Tel.: [phone]
                                FAX.: [phone]
                                BBS: [phone]
                                        login: ZOC

    North America

                               Simple Software Solutions
                                   4319 Fraser Street
                                 Vancouver, BC V5V 4G4
                                         CANADA

                                  Tel.: [phone]
                                      (604)-879-3563
                                  FAX.: [phone]

    Australia

                                     Andrew Tunney
                               Zillmere Computer Supplies
                                      P.O. Box 177
                                   Zillmere Brisbane
                                    Queensland 4034

                                  Tel.: [phone]
                                  FAX.: [phone]
                                  BBS:  [phone]
                                    FIDO: 3:640/221

 License
    There are two types of license available.

    Future license
       With an future license you get a key that entitles you as a single user
       to use all future versions of ZOC.

    Version license
       With a version license you get a key that is valid for a single user to
       use only those future releases that have the same major version number
       as the one you register (bug fixes are always treated als minor
       changes).

 Pricing

        ┌──────────┬───────┬─────────┬─────────┐
        │          │Germany│Australia│U.S.A. & │
        │          │       │         │Other    │
        ├──────────┼───────┼─────────┼─────────┤
        │Future    │DM 100 │AU$115   │US$70    │
        │license   │       │         │DM110    │
        ├──────────┼───────┼─────────┼─────────┤
        │Version   │DM70   │AU$85    │US$50    │
        │license   │       │         │DM80     │
        ├──────────┼───────┼─────────┼─────────┤
        │Version   │DM50   │AU$60    │US$40    │
        │upgrade   │       │         │DM60     │
        ├──────────┼───────┼─────────┼─────────┤
        │Compuserve│US$75  │US$75    │US$75    │
        │reg. (*)  │       │         │         │
        ├──────────┼───────┼─────────┼─────────┤
        │Disk      │DM10   │AU$15    │US$10    │
        │          │       │         │DM15     │
        ├──────────┼───────┼─────────┼─────────┤
        │Six pack  │-20%   │-20%     │-20%     │
        │(#)       │       │         │         │
        ├──────────┼───────┼─────────┼─────────┤
        │Mass      │-XX%   │-XX%     │-XX%     │
        │orders (+)│       │         │         │
        └──────────┴───────┴─────────┴─────────┘

    Note:  Pricing includes everything, no additional payment for shipping etc.
    required. Pricing for Europe/Germany includes 15% VAT/MwSt.

    (*)  since Compuserve charges 15% for the SWREG feature

    (#)  Orders for sixpack discount have to be mailed and paid together (not
    available from registration sites).

    (+)  Please contact author for a document describing the pricing of bulk
    orders (not available from registration sites).

 Payment

    Registration Sites
       If you plan to register from a registration site, please contact them
       for payment details.

    Credit Cards
       I accept VISA, MasterCard and Eurocard.

       Credit cards are charged in DM (see above list).

       To prevent credit card fraud I need an order form with your written
       signature (that is, a FAX or a letter) and with your credit card number
       and expiration date and/or a phone number that I can call back for
       confirmation of the order.

           Compuserve
       Compuserve offers a convenient shareware registration feature. To use it
       you need a Compuserve account. Compuserve registration is only available
       for future registrations without discount and costs additional $5 since
       Compuserve charges 15% for the SWREG feature.

           Check
       Checks are fine with me. Just send a personal check in the currency you
       like (covering the appropriate amount).

       If you order from Germany, send me an Euro- or Verrechnungsscheck.

           Cash
       If you send cash, please use registered mail. I will take the additional
       postage (that is, you pay $5 less for ZOC).

    Bank Transfer
       I guess this is convenient only if used from inside Germany. If you send
       money via Bank Transfer please send an order form (via mail) as well. My
       bank is POSTGIROAMT N–™RNBERG (BLZ 760 100 85), account is 0314153856.


‚ïê‚ïê‚ïê 3.4. Registered vs. unregistered version ‚ïê‚ïê‚ïê

Shareware is not an easy topic.

Unfortunately our world is not a perfect one. If it were, it would not be
neccessary to restrict (and sometimes cripple) shareware programs.

Endless discussions have not found the solution to the question, what fair
shareware should be like, because experience shows, that authors of
non-restricted shareware tend to die poor and hungry (or at least not rich and
well fed).

A common way to ensure payment is leaving something important out. So the
customer literally pays for what he does not yet have. Many shareware authors
play it this way. I do not, because I think that it is wrong.

In my opinion the customer has the right to test the full product package
before making a decision to buy it or not. I think this is fair, but fairness
must apply to both sides.

So, be fair too: Register this program if you use it!

Early version of ZOC were restricted in ZModem downloads. This was removed due
to user requests. Now the only difference between registered and unregistered
versions of ZOC is the fact that unregistered versions shows the order form
after each download.

Please don't try to discuss this with me. I will not remove this and if you
call it nagware, maybe you are already using ZOC enough to register anyway.


‚ïê‚ïê‚ïê 4. Screen Elements ‚ïê‚ïê‚ïê

The elements of the screen are the

o Actionbar

o Toolbar

o Main Window

o Chat Field

o Status line


‚ïê‚ïê‚ïê 4.1. Actionbar (pulldown menus) ‚ïê‚ïê‚ïê

The actionbar lets you select functions from the pulldown menu (see  Menu
Overview).


‚ïê‚ïê‚ïê 4.2. Toolbar ‚ïê‚ïê‚ïê

Some of the most commonly used functions can be selected by clicking on the
according icon on the toolbar.

  Modem Phone Book

  Modem Dial

  Modem Hangup

  Capture Browse

  Capture Clear

  Capture Print

  Cliptext Send

  Cliptext Send without CRs

  Cliptext Send quoted

  Transfer Download

  Transfer Upload

  Transfer Plug In Protocols

  Misc Start Script

  Misc Stop Script

  Misc Reset Timer

  Misc Stop Timer

  Misc Go Timer

  End Program.

Doubleclicking on the space between the buttons will bring up the Window page
from the  Options Notebook


‚ïê‚ïê‚ïê 4.3. Main Window ‚ïê‚ïê‚ïê

The main window displays the received text. You may mark text with the right
(block selection) or left (stream selection) mousebutton. If you have the Ctrl
key pressed while doing the selection, the text will be appended to the text
that already is in the clipboard rather than overwriting it.

The marked text is copied into the clipboard and can be accessed via the
functions  Cliptext Send,  Cliptext Send without CRs,  Cliptext Send quoted,
Cliptext Print and  Cliptext Edit


‚ïê‚ïê‚ïê 4.4. Chat Field ‚ïê‚ïê‚ïê

The chat field is an entry field into which you can enter text. The text is not
sent until you press enter. This is helpful if you are having an online chat
with someone.

The chat field can be activated from  Window Options or by pressing Alt-C or by
pressing the Scroll-Lock key (the least, only if defined accordingly in
Terminal Options).

If you are in the chat field, it can discard it by pressing ESC or the
Scroll-Lock key.  Window Options or by pressing Alt-C or by pressing the
Scroll-Lock key (the least, only if defined accordingly in  Terminal Options).

You can use arrow keys to retrieve the last few lines you typed.


‚ïê‚ïê‚ïê 4.5. Status line ‚ïê‚ïê‚ïê

The status line contains some buttons with information.

 Serial Parameters
    This button displays the currently set line speed and parameters. Clicking
    on the button brings up the  Serial Options dialog.

 Transfer Protocol
    This button displays the currently set file transfer protocol. Clicking on
    the button brings up the  Transfer Options dialog.

 Emulation
    This button displays the currently set terminal emulation. Clicking on the
    button brings up the  Emulation Options dialog

 Timer
    This button displays the timer. The value depends on the currently set mode
    (see  Timer Options).

    A lowercase letter a-d means that a timer unit is selected and that the
    timer was stopped. A capital letter indicates that the timer is running. A
    '1' after the letter indicates daytime charges, a '2' indicates night or
    weekend charges.

    A click on the button brings up the  Timer Options dialog.

 LEDs
    The four LEDs in the status line provide two services:

    If they are red they display additional status information (LED 1 shows the
    carrier detect status of the modem, LED 2 shows if you are running a
    script. LED 3 and 4 emulate the modem receive-data and send-data LEDs, and
    can be turned off in the  window options).

    If they turn green, your host has requested the Vt100 LED service and sets
    the LEDs according to the application you run. The LEDs will stay green
    until you change the emulation or clear the screen from the misc menu.

 Logfile
    This checkmark displays the name of the logfile and opens or closes it.

Doubleclicking on the space between the buttons will bring up the terminal page
from the  Options Notebook


‚ïê‚ïê‚ïê 5. Keyboard ‚ïê‚ïê‚ïê

Select  Keyboard Shortcuts or  VT102 Auxiliary Keypad


‚ïê‚ïê‚ïê 5.1. Function Shortcuts ‚ïê‚ïê‚ïê

┌────────────┬────────────────────┐
│Key         │Function            │
├────────────┼────────────────────┤
│PgUp        │Upload              │
├────────────┼────────────────────┤
│Ctrl+PgUp   │ASCII Upload        │
├────────────┼────────────────────┤
│PgDn        │Download            │
├────────────┼────────────────────┤
│Shift+Insert│Cliptext Send       │
├────────────┼────────────────────┤
│Alt+Insert  │Cliptext Send Spaced│
├────────────┼────────────────────┤
│Ctrl+End    │Modem Send Break    │
├────────────┼────────────────────┤
│Alt+B       │Capture Browse      │
├────────────┼────────────────────┤
│Alt+C       │Show/Hide Chat      │
├────────────┼────────────────────┤
│Alt+D       │Modem Phone Book    │
├────────────┼────────────────────┤
│Alt+E       │Misc Editor         │
├────────────┼────────────────────┤
│Alt+H       │Modem Hangup        │
├────────────┼────────────────────┤
│Alt+J       │Transfer            │
│            │Transfer-Shell      │
├────────────┼────────────────────┤
│Alt+L       │Capture Open/Close  │
├────────────┼────────────────────┤
│Alt+N       │Modem Call Next     │
├────────────┼────────────────────┤
│Alt+P       │Options Settings    │
│            │Serial              │
├────────────┼────────────────────┤
│Alt+Q       │Cliptext Send Quoted│
├────────────┼────────────────────┤
│Alt+R       │Modem Redial        │
├────────────┼────────────────────┤
│Alt+S       │Options Settings    │
├────────────┼────────────────────┤
│Alt+U       │Transfer Plugs      │
├────────────┼────────────────────┤
│Alt+X       │End Program         │
├────────────┼────────────────────┤
│Alt +       │Start Script        │
├────────────┼────────────────────┤
│Alt -       │Stop Script         │
├────────────┼────────────────────┤
│Alt /       │Misc OS/2 Shell     │
├────────────┼────────────────────┤
│Alt #       │Misc Clear Screen   │
├────────────┼────────────────────┤
│Alt *       │Cliptext Print      │
└────────────┴────────────────────┘


‚ïê‚ïê‚ïê 5.2. VT102 Auxiliary Keypad ‚ïê‚ïê‚ïê

┌────────────┬───────────────┐
│VT102 Keypad│IBM Keypad (Num│
│            │Lock Off)      │
├────────────┼───────────────┤
│[PF1]       │[F1]           │
├────────────┼───────────────┤
│[PF2]       │[F2]           │
├────────────┼───────────────┤
│[PF3]       │[F3]           │
├────────────┼───────────────┤
│[PF4]       │[F4]           │
├────────────┼───────────────┤
│[0] ... [9] │[0] ... [9]    │
├────────────┼───────────────┤
│[Enter]     │[Enter]        │
├────────────┼───────────────┤
│[.]         │[./Del]        │
├────────────┼───────────────┤
│[-]         │[-]            │
├────────────┼───────────────┤
│[,]         │[+]            │
└────────────┴───────────────┘


‚ïê‚ïê‚ïê 6. Menu Overview ‚ïê‚ïê‚ïê

Open this branch by pressing the '+' key. or select one of

o MODEM

o LOGFILE

o CAPTURE

o CLIPTEXT

o TRANSFER

o MISC

o OPTIONS


‚ïê‚ïê‚ïê 6.1. Modem Menu ‚ïê‚ïê‚ïê

The modem menu manages all necessary functions to connect to line.

 Init
    This function sends the init string defined in the  Modem Options to the
    modem to reset it. It will do this regardless of the carrier detect state.

 Dial
    This function opens a window to enter a phone number. This number is then
    sent to the modem to be dialled (dial prefix and suffix from  Modem Options
    are used).

 XDial
    This function starts a  Script If the number is busy, the script tries to
    connect again for a given number of times.

    You can edit this script. It is stored in the default script directory
    under the name SCRIPT\XDIAL.

 Redial
    Redials the number dialed last. (dial prefix and suffix from  Modem Options
    are used).

 Hangup
    Disconnects the line (the Attn and Hangup strings from  Modem Options are
    used).

 Send Break
    Pulls the data pin of the modem low for a given time (see  Modem Options).
    This is called 'break'. Some systems use it to stop the current operation.

 Phone book
    Displays a dialog to edit a personal phone book or dial numbers from it.

 Call next
    If you selected more than one number to dial from the phone book, this
    function tries to connect to the next number selected after finishing your
    first call.

    This Feature is called queue dialing. Like XDial it is implemented as a
    Script

 Call XXXX
    At the end of the modem menu appear those entries from the phone book that
    have the quick access option enabled.


‚ïê‚ïê‚ïê 6.2. Logfile Menu ‚ïê‚ïê‚ïê

The logfile menu manages all functions necessary to log a session to a file.
All incoming data is captured in a memory buffer (capture) and optionally
logged to a file (logfile).

 Name
    Set the Name of the current logging file. The name can be automatically
    selected from the phone book when connecting to a bbs. When starting ZOC
    the logfile gets its name from  Capture Options. You may use special
    placeholders for the name as described in the  Capture Options.

 Default Name
    Use the default name from  Capture Options for the current logging file.

 Open/Close
    This function changes the status of capturing to file from open to close or
    vice versa. This can also be achieved by clicking on the capture name in
    the  status line

    A closed capture does not log incoming data.


‚ïê‚ïê‚ïê 6.3. Capture Menu ‚ïê‚ïê‚ïê

The capture menu manages all functions necessary to log a session in memory to
scroll back and review received text. All incoming data is logged in a memory
buffer (capture) and eventually in a file (logfile).

 Browse
    This function shows the contents of the capture. It can also be accessed
    from the  Toolbar

    For more information see  Browse Window

 Clear
    Clears the capture buffer (also availalble from the  Toolbar).

     affected by  Safety Options

 Load
    Loads a file from disk to the end of the view buffer.

 Edit
    Starts the editor from  editor definition with the contents of the capture
    buffer and stores changes back into the capture buffer.

    Note:  This functions closes the browse window if it is open.

 Print
    Sends the contents of the view buffer to the printer (also availalble from
    the  Toolbar).


‚ïê‚ïê‚ïê 6.4. Cliptext Menu ‚ïê‚ïê‚ïê

Cliptexts are areas of the screen that are marked with the mouse (left or right
button) and put into the clipboard after the mousebutton is released.

 Mark
    This function is just an info message of how to put text from screen into
    the clipboard.

 Send
    This function takes text from the clipboard and sends it to the modem. It
    can also be accessed from the  Toolbar and is affected by the  Ascii Upload
    Options .

 Send (no CRs)
    Takes text from the clipboard and sends it to the modem. Carriage Returns
    are ignored and a Space is sent instead. The function can also be acccessed
    from the  Toolbar and is affected by the Ascii Upload Options in the
    Transfer Options window.

    Imagine the following case: You searched a BBS for files with the keyword
    TERM and the BBS has given you a list of filenames - one in each line. To
    download all files, you could mark the list with a box (right mouse button)
    and send them with a space between them when the BBS asks which file(s) to
    send.

 Send quoted
    Text from the clipboard is sent. Each line is preceeded by '> ' to indicate
    a quotation. If you press the shift key while selecting this function, ZOC
    will reformat the text to fit into the line before sending it. The function
    is also available from the  Toolbar and is affected by the Ascii Upload
    Options in the  Transfer Options window and 'Quote always smart' in the
    Window Options window.

 Edit
    Calls the system editor (see  editor definition) with the contents of the
    clipboard. After saving, the new contents is written back into the
    clipboard.

 Print
    Sends the contents of the clipboard to the printer.


‚ïê‚ïê‚ïê 6.5. Transfer Menu ‚ïê‚ïê‚ïê

The transfer menu allows you to send or receive files.

 Upload
    Sends a binary file via modem. The function can also be accessed from the
    Toolbar and is affected by the  Transfer Options window.

 Download
    Receives a binary file via modem. The function can also be accessed from
    the  Toolbar and is affected by the  Transfer Options window.

 ASCII Send
    This functions takes text from a file and sends it to the modem. It is
    affected by the Ascii Upload Options in the  Transfer Options window.

 Plugs
    This function gives access to add in modules (so called Plug-In-Protocols)
    and lets you do Setup, Upload or Download for them. Plug-In-Protocols are
    provided from third party and are stored in DLL files named PIP*.DLL.

    If no such modules exist this function is disabled.

 Transfer Shell
    Transfer shell launches a command processor from which you can start
    command line based external protocols that can accept a file handle for the
    com port. The handle of the communications port is given in the environment
    variable ZOCHFC.

    Example: M2ZMODEM -u %ZOCHFC% -r .\DOWNLOADS


‚ïê‚ïê‚ïê 6.6. Miscellaneous Functions ‚ïê‚ïê‚ïê

 Start Script
    Starts a script. A script is sort of batch file for ZOC, which helps
    process specific tasks automatically (see  Script).

    This function can also be acccessed from the  Toolbar

 Stop Script
    Stops a currently running script.

    This function can also be accessed from the  Toolbar

 Lock Macros
    Lock the macro keys to prevent unauthorized use.

 Unlock Macros
    Unlock the macro keys again. If defined, the password from  Safety Options
    is required.

 Reset Timer
    Reset the timer in the status line which displays the time or cost of your
    current call.

    This function can also be accessed from the  Toolbar

 Stop Timer
    Stop the timer in the status line which displays the time or cost of your
    current call.

    This function can also be accessed from the  Toolbar

 Go Timer
    Restarts the timer in the status line which displays the time or cost of
    your current call.

    This function can also be accessed from the  Toolbar

 Set Timer
    Set the timer to a specific value.

 Clear Screen
    This functions just clears the terminal screen and sets the LEDs in the
    statusline

 Editor
    Call the editor defined in the options notebook on the ( Path page).

 OS/2 Shell
    Call the shell defined in the options notebook on the ( Path page).


‚ïê‚ïê‚ïê 6.7. Options Menu ‚ïê‚ïê‚ïê

The options menu is used to define the characteristics of ZOC. Different sets
of characteristics may be saved or loaded for later use.

 Settings
    Opens a settings notebook to define all kind of options (see  Options
    Notebook).

 Jump to
    Display a submenu (see below) to jump to a specific options dialog.

 Save
    Save all of the above options under a special name. If saved under
    'STANDARD' they will be loaded automatically when ZOC is started.

 Load
    Load a set of options.

 Reset
    Reset to the default state.

The Jump to menu is a fast way to access the pages of the options notebook
directly.

 Serial
    Define serial options (e.g. transfer speed and handshake).

    This function can also be accessed from the  Status line

 Terminal
    Define terminal and capture characteristics (e.g. local echo, CR
    translation).

 Capture
    Define captrure parameters (e.g. size).

    This function can also be accessed from the  Status line

 Modem
    Define modem strings for dialing or hangup.

 Transfer
    Define transfer options for file or ascii transfer (e.g. protocol or
    character delay).

    This function can also be accessed from the  Status line

 Emulation
    Define terminal emulations like ANSI, VT102 or TTY.

    This function can also be accessed from the  Status line

 Timerunits
    Define time intervals for calculating connect fees.

 Safety
    Define when to be prompted for safety or define a password to protect key
    macros.

 Path
    Define default directories for the filerequesters.

 Macro Keys
    Define key-macros for later use. These may be password protected (see
    Safety).

 Window
    Define the window font and other display options.


‚ïê‚ïê‚ïê 7. Browse Window ‚ïê‚ïê‚ïê

The browse window lets you review the contents of the capture buffer.

To control the browse window, use the following keys.

┌────────────┬────────────────────┐
│Key         │Function            │
├────────────┼────────────────────┤
│Csr Up      │One line up         │
├────────────┼────────────────────┤
│Csr Dn      │One line down       │
├────────────┼────────────────────┤
│PgUp        │One page up         │
├────────────┼────────────────────┤
│PgDn        │One page down       │
├────────────┼────────────────────┤
│Home        │Top of buffer       │
├────────────┼────────────────────┤
│End         │Bottom of buffer    │
└────────────┴────────────────────┘

You may also mark text with the mouse (which is automatically put into the
clipboard then).


‚ïê‚ïê‚ïê 8. Help for Options ‚ïê‚ïê‚ïê

Open the settings notebook, select a page and clicon on the Help button.


‚ïê‚ïê‚ïê 9. The Options Booklet ‚ïê‚ïê‚ïê

This booklet contains all options. Select a tab with the mouse to open the
according dialog.

Available tabs are:  Serial,  Terminal,  Capture,  Modem,  Transfer,
Emulation,  Pathnames,  Safety,  Macro Keys,  Window


‚ïê‚ïê‚ïê 9.1. Serial Options ‚ïê‚ïê‚ïê

This window is used to define serial parameters. It can be opened via menu or
by clicking on the transfer speed button in the status line.

 Transfer Speed
    Select a transfer speed for serial transmission (the transfer speed can
    also be selected using a script and the BAUD command).

 Mode
    Select none, even, odd, mark or space.

 Databits
    Select 7 or 8 bits for data transmission.

 Stopbits
    Select 1 or 2 stopbits.

 RTS/CTS handshake
    If enabled, ZOC uses 7-wire handshake for communication.

 DSR handshake
    If enabled, ZOC monitors the DSR signal for communication with the modem.
    This option should only be enabled if your modem and your cable properly
    support DSR. Otherwise the com port will hang.

 XON/XOFF
    If enabled, ZOC uses the Xon/Xoff software handshake for communication.

 Auto speed
    If enabled, ZOC automatically sets the transfer speed to the one received
    when the modem sends a message like 'CONNECT xxxxx'.

 Valid CD signal
    If your modem supports the Carrier Detect signal, enable this option. ZOC
    uses the CD signal to call the functions Stop/Go/Reset Timer in the  Misc
    Menu automatically and eventually writes a calling log to the file defined
    in  Path Options.


‚ïê‚ïê‚ïê 9.2. Terminal Options ‚ïê‚ïê‚ïê

This window is used to define terminal parameters.

 TERMINAL

    Incoming CR -> CR/LF
       This options ensures, that each incoming Carriage Return is followed by
       a Linefeed.

    Strip high bit
       If enabled, all characters in the terminal window are printed with 7
       bits.

    Show ctrl chars
       Shows received control-codes instead of using them (eg. ^I instead of
       TAB).

    Destructive backspace
       This options erases on backspace instead of just spacing back.

    Local echo
       Print all characters sent on the console on the terminal window too.

    Send echo
       Loop back all incoming characters to the originator.

       Warning: This may result in an endless loop if the originator also sends
       an  echo (!!!), which is true for most BBS's and hosts.

    Beep
       This options controls what to do for a beep. Choices are ignore
       (unchecked), acoustic (checked) or visual (shaded). instead).

 CLIPBOARD SENDING

    Quote always smart
       If selected, the Cliptext Send Quoted function will always try to
       reformat the text before sending it quoted. If this is disabled, text
       will be reformatted if you select the send-quoted function with the
       shift key pressed.

    Width
       Reformatting will be done in a way that no line is longer than the
       number of characters specified here.

    Always send quick
       Selecting this option will always send marked text at once if only one
       line is marked on the screen with the left mouse button. Otherwise the
       text will be sent at once, only if you press the Shift key when doing a
       one-line selection.

 SCROLL LOCK

           Ignore
       ZOC ignores the scroll lock state of the keyboard.

    Chat field
       Pressing the Scroll Lock key toggles the chat mode (see  window options
       and  screen elements).

    Doorway mode
       Pressing the Scroll Lock key toggles the keyboard Doorway mode. (Doorway
       mode is a mode in which special key codes are used. It is required by
       software like OS2YOU).


‚ïê‚ïê‚ïê 9.3. Capture Options ‚ïê‚ïê‚ïê

This window is used to define capture parameters and can be opened via menu or
by clicking on the capture size button on the status line.

     Size
    Define the size of the capture buffer (in kB's).

 Default name
    When you start ZOC, this name will be used as a default name for the
    logfile. You may use &d, &m, &y, &h, &i as place holders for day, month,
    year, hour and minute to create dynamic names. The file will be placed in
    the logging directory set in  Path Options

 Active
    Save incoming data in the logfile. This is the same as the checkmark in the
    status line.

 Append
    If logging is activated, data is appended to a existing file rather than
    overwriting it when you start logging.

 Session headers
    Session headers are a few lines of information which are inserted into your
    capture and logging file when connecting to a BBS. Headings are only
    produced if you have a valid carrier detect signal (see  Serial Options).


‚ïê‚ïê‚ïê 9.4. Modem Options ‚ïê‚ïê‚ïê

This window is used to define the strings ZOC uses to communicate with your
modem. These strings may contain control characters (eg. ^M) and the tilde (~)
which is a delay of 1/3 sec.

If you deselect the checkbox for 'Initialize when load' the initialisation
sequence is used only at startup of program (from the standard options file).
If the checkbox is selected, the init string is sent every time a options file
is loaded.

However, the init sequence is sent only, if ZOC finds no valid carrier detect
signal from the modem or if you specify that you want the modem to be
initialized even if a carrier signal is detected.

If you select the checkbox 'Use DTR for hangup' ZOC pulls the DTR pin of the
serial interface low for 0.5 seconds instead of sending the escape and hangup
strings. If configured with the AT&D2 command, most modems will hang up on a
dropped DTR signal.


‚ïê‚ïê‚ïê 9.5. File Transfer Options ‚ïê‚ïê‚ïê

These settings define the characteristics of file transfers. They are accessed
via the Options/Settings notebook or by clicking the protocol button on the
status line.

 PROTOCOL
    Select X- Y- or Zmodem protocol. Zmodem is clearly the best. Some systems
    falsely also offer the protocols Ymodem and Ymodem batch, which really are
    Xmodem with Block-1024 for Ymodem and Ymodem for Ymodem-Batch.

 Time critical
    Enabling this options boosts ZOC's priority during file transfers, which
    might help to increase transfer throughput and reduce transfer errors.

    Note:  This will very likely impair the performance of other tasks.

 XMODEM PARM
    These options only apply when the Xmodem protocol is selected.

    CRC on
       CRC is controlled by the receiver. It selects CRC instead of the less
       reliable Xmodem checksums.

    Block 1024
       With this option Xmodem uses blocks of 1024 instead of 128 bytes. Some
       systems falsely call this Ymodem.

    Chop
       If enabled, ZOC tries to remove padding bytes when receiving a file.

 ASCII-UPLOAD
    These options are used for ASCII-Uploads and sending of the clipboard
    contents.

    CR -> CR/LF
       Ensures that each Carriage Return is followed by a Linefeed.

    Char-Delay
       ZOC waits n milliseconds, before sending each character. Fourth this
       time is used for each end of line.

 ZMODEM OPTIONS

    Auto transfer
       If enabled, ZOC starts Zmodem transfers automatically.

    Start taps
       A tap is an add-in function for download. If enabled, ZOC checks if you
       have a tap for the currently downloaded file extension (eg. a
       GIF-Viewer) and starts it. The name of a tap is TAP_XXX.EXE where XXX is
       the extension of the files for which the tap should be used.

 IF FILE EXISTS
    Select what you want to do if you try to download a file that already
    exists on your disk. Additionally select if you want the old (existing) or
    the new (incoming file) renamed.


‚ïê‚ïê‚ïê 9.6. Emulation Options ‚ïê‚ïê‚ïê

This window is used to set the emulation. It can be opened via menu or by
clicking on the emulation button in the status line.

 Swap keys
    If you enable the keys swap option, a Backspace is sent when the DEL key is
    pressed and vice versa. This is helpful for many VT102 systems.

 Discard codes
    Screen control for ANSI and VT102 is done by sending special control codes.
    Logging of these control codes in the capture may be disabled.

 Disable VT102 key pad
    In VT102 mode the numeric key pad is used as the VT102 auxiliary keypad
    (see  VT102-keyboard). This might be problematic on machines without an
    numeric keypad (eg. Laptops) and can be disabled.

Note:  If you need the auxiliary keypad for a VT102 system, press Shift+Ctrl
and a key from the keypad (use '+' for VT102-',' and use 'Del' for VT102-'.').
If you need VT102-PF1/2/3/4 press Ctrl+Shift+F1/2/3/4 instead.


‚ïê‚ïê‚ïê 9.7. Timer and Timerunit Options ‚ïê‚ïê‚ïê

Phone units are used to monitor telephone charges, if charges are based on time
intervals.

Currently this function might be useful only in Germany.

In Germany phone call are charged based on time intervals (called phone units)
with a fixed cost but variable length. The longer the distance of the call, the
shorter the time interval. There are three distance zones (local/med/long) and
there is a distinction between day and night/weekend calls.

 Units
    You may define up to four time intervals (in seconds and for day and night)
    and the cost for one interval.

 Show timer as

    Elapsed time
       The status line shows time elapsed since resetting the timer.

    Money
       This option shows the time elapsed since resetting the timer as a money
       value.

    Fraction
       This option shows how many units were used.

    Clock
       The time of day is displayed.

 Warning
    If this field is any other value than zero (eg. '80'), ZOC signals at this
    specified point in time (eg. 80%) to give you the opportunity to cut the
    connection before another time interval begins, thus saving you from paying
    for more units than necessary.


‚ïê‚ïê‚ïê 9.8. Safety Options ‚ïê‚ïê‚ïê

Define if you want to be warned before attempting some "dangerous" operations.

 Ask 'are you sure'
    This should be self explanatory.

 Warning if high speed ...
    The RTS/CTS handshaking method provides reliable control of the data flow
    between the PC and the modem. If you use high transfer speeds without
    RTS/CTS handshake you will verly likely encounter transmission errors.
    Enabling this option gives you a warning if you select more than 2400 baud
    without selecting RTS/CTS as well.

 Save options ...
    Here you can select if you want to save options automatically when you
    leave the program. If this option is deselected potential changes are
    discarded at the end of program.

 Lock Macro Keys
    If you leave your computer unattended for a while, you can lock the macro
    keys to prevent unauthorized use. To unlock them, the password will be
    asked for. Locking can also be initiated from the  Misc Menu.

 Password
    If a password is specified, the dialogs for Phone book Definition, Keymacro
    Unlocking and  macro key definition will ask for it, because all passwords
    for accessing online services are stored in these dialogs.

        CAUTION:
    The password is case sensitive and there is no backdoor if you forget it.


‚ïê‚ïê‚ïê 9.9. Definition of Default Pathnames ‚ïê‚ïê‚ïê

The pathnames defined here are the default directories for file requesters or
special functions.

The 'QWK Dl.' field defines a directory into which downloaded files Quick-Mail
(*.QW?) or BlueWave-Mail-Packets (*.MO?, TU?, WE?, TH?, FR?, SA?, SO?) are
stored. This is helpful with the popular fido offline news readers (eg. Kurt
Westerfield's excellent KWQ product).

Editor defines the editor to be used when calling the Cliptext Edit function
from the  Cliptext menu, or when calling the Edit function from the  Misc menu.

Shell defines a shell to be opened, when calling the OS/2 Shell function in the
Misc menu.

The logging file is not written if you have 'valid CD signal' disabled in the
serial options.

If a logfile is defined, ZOC logs all calls (time, duration, cost) to it.


‚ïê‚ïê‚ïê 9.10. Window Property Definition ‚ïê‚ïê‚ïê

 Screen size
    Defining the screen size in the options booklet is not yet possible. Right
    now you have to specify the screen size via  command line parameters.

 SCREEN ELEMENTS

    Initial Help
       Here you can turn off the initial help display.

           Toolbar
       Here you can turn off the toolbar.

    Large toolbar
       Enabling this option makes the buttons of the toolbar bigger.

    Status line
       Here you can turn off the status line.

    Chat field
       Here you can turn off the chat field (see  screen elements). The chat
       field can be turned on and off with the Scroll-Lock key if you defined
       this in  terminal options.

    Disable RD/SD ...
       Here you can turn off the (maybe annoying and processor time consuming)
       flashing of the two LEDs in the  statusline that emulate the modem
       receive-data and send-data LEDs. If the checkmark is in indefinete state
       (shaded) the LEDs will be disabled during file transfer only.

    Jump to top if DCD
       If set, the main window of ZOC will come to the top of the desktop if
       the modem DCD (data carrier detect) signal is switched on.

    ... to top after transfer
       If set, the main window of ZOC will come to the top of the desktop after
       a file transfer has been completed.

    Big cursor
       Enabling this option makes the cursor in the main window a bit bigger.

 Font size
    Select a font size for the terminal window from the list. Selection of
    other fonts is not possible.

 Scrolling
    Since PM applications need to move far more data to scroll text than
    fullscreen applications, ZOC is only able to print modem input to the
    screen with about 4800 bps. To achieve higher speeds, you can allow ZOC to
    delays scrolling until a few lines (eg. five) of text arrive. Thus ZOC only
    needs to scroll only once (instead of having to scroll five times). The
    higher the speed you select (normally brisk scrolling should be enough) the
    more lines ZOC will collect before actually scrolling and the more jumpy
    the display will look.


‚ïê‚ïê‚ïê 9.11. Macro Key Definition ‚ïê‚ïê‚ïê

Select strings to be sent when F4-F12 or Shift F1-F12 is pressed. Use the caret
to define control codes (like ^M for <Enter>).

You can map the execution of a script file onto a function key if you define
the key as '^$=<scriptname>' (eg. '^$=SCRIPT\MY_SCRIPT')

If you use the special code of ^& in a macro key, ^& will be substituted with
the value of the password field of a phone book entry after you connected to
that BBS via the phone book. (see  phone book entries).


‚ïê‚ïê‚ïê 10. Phone book ‚ïê‚ïê‚ïê

Select  How to use the phone book or  Changing a phone book entry.


‚ïê‚ïê‚ïê 10.1. How to use the phone book ‚ïê‚ïê‚ïê

Just like in a real phone book, names and numbers are stored here. It is
subdivided into four sections (default, 1st, 2nd and 3rd alternate) which
means, that you practically have four different phone books.

Each entry in a phone book can be defined to simply dial a number once, dial a
number repeatedly until you get a connection or execute a  Script.

If you select more than one entry, ZOC will create a file called DIALQUE as a
to-do list and start the QUEDIAL script to connect to the first available BBS
from that list. After leaving the BBS, you can process the rest of the list
with the Call Next function from the modem menu.

Note:  When QUEDIAL connects to a BBS it deletes all entries from the to-do
list that are equal to the connected BBS in the first six characters. This way
you can connect to a multi line BBS (eg. Avalon-1, Avalon-2 ...). If one line
is free the others will not be called again.

 Dial
    Execute the operation (Dial, XDial, Script) for the selected entry.

 Delete
    Delete selected entry from phone book.

 Edit
    Change the data of the selected entry (see  changing a phone book entry).

 New
    Create a new entry to this phone book.

 Clone
    Create and edit a copy of the selected entry.

 Default
    Switch to the default phone book.

 Book#1
    Switch to the 1st alternate phone book.

 Book#2
    Switch to the 2nd alternate phone book.

 Book#3
    Switch to the 3rd alternate phone book.


‚ïê‚ïê‚ïê 10.2. Changing a phone book entry ‚ïê‚ïê‚ïê

 Name
    A name for the entry. For multi port BBSs use names that are equal in the
    first six characters (eg. AVALON-1, AVALON-2 ...). This way the queue dial
    feature will not try to connect to all of the ports, but only to one.

 Password
    You can add a password for the BBS here. If you connect to the BBS you can
    access the password by defining a macro key as ^&.

    That is, if your F12 key is set to the text '^&', you can answer the
    password prompt of the BBS by pressing F12 (see  macro keys).

    However, it is more convenient to let the Autologin feature (see below)
    handle the entire login.

 Memo
    This field stores a short (60 characters) note about the BBS. You might
    want to enter the name of the sysop or other info about the BBS here.
    However, for passwords you should use the autologin feature (see below)
    instead.

 Call after XX days

    If ZOC finds a carrier detect signal after calling a BBS, it will try to
    find the BBS name in the phone book and update the date of last call for
    all phone book entries that are equal to the one that was called in the
    first six characters of the name (thus managing multi-line BBSes correctly,
    see above).

    You may define a time period, after which you want to call the BBS on a
    regular base. If ZOC finds that another call is due, you will see the text
    '[CALL DUE]' in the selection list indicating that you should call the BBS
    again.

 Quick access
    Select this if you want the BBS to be accessible from the modem menu.
    Insert a tilde before a character in the name (eg. 'ZOC ~Infobbs'), to
    create a shortcut for the menu.

 Serial parameters
    Serial parameters to be set before calling the number (eg. 19200-8N1).

    If you leave this field blank, the current setting or the setting from a
    loaded options file will be used.

    You may leave out the options (and just type a line speed).

    If you just want to set the options and leave the current line speed
    unchanged set the speed to zero (eg. 0-7N1).

 Option file
    Option file to be loaded before setting the serial parameters and dialling
    the number. The option file must be preceded by a path (eg.
    OPTIONS\COMPUSRV.OPT).

 Logfile
    Name to be used for logging the session. Special placeholders can be used
    as described in  Capture Options.

 Phone/Script
    A phone number or the name of a scriptfile (the script file must be
    preceded by a path eg. SCRIPT\CALL_ZOC).

 Emulation
    Select emulatoin to switch to before calling the BBS.

 Type of action
    Select if the string in the phone/script field is a number to dial once, a
    number to dial repeatedly until connection is established or if it is the
    name of a script to be executed. A script receives the  Name, and
    Autologin fields in the lastline variable and may use them for own purposes
    (that it could define new keywords for the autologin field).

 Phone book
    Select the phone book to store this entry to.

 Zone
    Select the distance zone for the BBS (see  Options Units).
    Day/Night/Weekend is selected automatically.

 Autologin
    If you select XDial as the type of value (see below), this field is a
    sequence of keywords (separated by bars '|') that control the redial and
    login process.

    S0=...
       If defined, S0 is sent unconditionally after carrier detect.

    Wn/Sn=...
       Define pairs of words to wait for and to reply then. Text to wait for is
       defined as W1, W2 ..., the corresponding text to be send is defined as
       S1, S2 ....

    INIT=...
       Optional init string to send to the modem before trying to connect to
       the BBS

    WAIT=...
       Optional time in seconds to wait between unsuccessful attempts (XDIAL
       only).

    Note
       Keywords must not be lowercase letters

    Example


              INIT=ATZ1^m|WAIT=30|W1=ESC|S1=^[|W2=Name|S2=Zaphod^M|W3=Password|S3=HeartOfGold^M

       This example means: Init the modem with ATZ1 and wait 30 seconds after
       an unsuccessful attempt. To log in wait for the text 'ESC' from the BBS,
       then send the ESC character, then wait for the text 'Name' then send
       'Zaphod', then wait for the text 'Password' and send the text
       'HeartOfGold'.


‚ïê‚ïê‚ïê 11. Help for File Transfer ‚ïê‚ïê‚ïê

File Transfer lets you send or receive binary files. Uploading is sending,
download means for receiving a file. See  Options Transfer for more
information.

Note:  The speed indicator for Z-Modem reflects the transfer speed of the last
block, not the average speed from the beginning of the transfer. Total average
speed is shown at the end of the transfer.

 Information: If you use an unregistered version (see  Registration), the order
form will be displayed after each download.


‚ïê‚ïê‚ïê 12. Script Language Commands ‚ïê‚ïê‚ïê

This is a short reference of all available script commands. For more
information about variables and common commands see the samples in the
SCRIPT\SAMPLES directory.

See the program extract at the end of the list as a prerequisite for the some
of the examples.

 ADD <meta> <num>Add a number to a variable.

     Example:

           ADD VARN 11; WRITELN %VARN%
     => 110

 ASK [<text>]Read text from user. Result in %lastline%.

     Example:

           ASK "Are You sure?"

 BAUD <baud>[-{7|8}{N|O|E}{1|2}]Set serial parameters.

     Example:

           BAUD 4800-8N1

 BEEP [<n>]Beep n times

 CALL <label>Call a label (defined as ':label') as subroutine (see RETURN).

     Example:

           CALL Label

 CAPTCLRClear the capture buffer

 CLOSEFILEClose the file opened with OPENFILE

 CLS Clear the screen

 COMPA <string> WITH <string>Compare two ASCII strings (see EXACT, IFxxx)

     Example:

           COMPA "%VAR1%" WITH "%VAR2%"

 COMPN <num> WITH <num>Compare numeric values

 DEBUG 0|1Debugmode off/on

 DEC <meta>Decrement numeric variable by one.

     Example:

           DEC VARN

 DELAY [<sec>]Wait given time in seconds or delay 1/5 second if parameter is
     omitted.

 DIAL [<number>]Dial a number or display dial requester.

 DIV <meta> <num>Divide a variable by a number

 DOWNLOAD {X[C]|Y|Z} <file>Download file with X/Y/Zmodem (Zmodem can be done
     with the ZOC's autodownload feature as well).

 ENDSCRIPTSame as EXIT

 ENDZOCTerminate ZOC and return to shell or WPS

 EXACT 0|1Set exact mode for COMPA. EXACT 1 means, that the two strings must be
     exactly equal. EXACT 0 means, that the are compared in the length of the
     shorter string (that is, line [6] in the example below would result to
     equal).

 EXITEnd the script

 EXTERN <scriptfile> [<parameter>]Execute other scriptfile. The other
     scriptfile gets the parameter in the %lastline% variable.

 GETENV <name>Read value from environment into %lastline%.

 GETFILERead line from ASCII file opened with OPENFILE into %lastline%

 GETFILENAME <title>Display filerequester and return name in %lastline%

 GOTO <label>Jump to label (defined as ':label')

 HANGUPDisconnect from line

 IFBRK <command>Do command if the last WAIT/WAITLINE returned due to timeout.

     Example:

           IFBRK GOTO ERROR

 IFEQU <command>Do command if the operands of the last COMPx (COMPA/COMPN) were
     equal.

     Example:

           IFEQU SETN X 0

 IFHIGH <command>Do command if first operand of the last COMPx was greater than
     the second.

     Example:

           IFHIGH SEND "^X^X^X^X"

 IFIN <command>Do command if first operand of the last COMPA was found
     somewhere in the second.

 IFLOW <command>Do command if first operand of the last COMPx was lower than
     the second.

 IFNBRK <command>Do command if the last WAIT/WAITLINE returned with the text
     found.

 IFNEQU <command>Do command if result from last COMPx was not equal.

 IFNHIGH <command>Do command if first operand of the last COMPx was lower than
     or equal to the second.

 IFNIN <command>Do command if first operand of the last COMPA was not

 IFNLOW <command>Do command if first operand of the last COMPx was greater than
     or equal to the second.

 INC <meta>Increment numerical variable by one.

     Example:

           INC VARN

 KILL <meta>Remove variable from memory (not explicitely necessary).

     Example:

           KILL VARN

 LOADOPTS <optsfile>Load options file.

     Example:

           LOADOPTS "OPTIONS\VT100OPT"

 LOGNAME <filename>Set new name for logging.

     Example:

           LOGNAME "TODAY.LOG"

 LOGGING [0|1]Suspend/resume logging

 LOWER <meta>Convert value of variable to lowercase (see UPPER).

     Example:

           LOWER VAR1

 LTRIM <meta>Remove blanks from beginning of variable (see RTRIM).

     Example:

           LTRIM VAR1

 MAXSCAN <num>Set maximum recursion for meta replacement. Variables can contain
     refereces to other variables (eg. SETA V1 "%%V2%%", SETA V2 "%%V3%%",
     SETA V3 "Hello World"). MAXSCAN defines the maximum scanning depth for
     such value expansions. That is, normally "%V1%" would expand to "Hello
     World", while it would expand to "%V2%" if MAXSCAN were '1'.

 META <newchar>Change meta character "%" into something else.

     Example:

           META $; WRITELN "$VAR1$"

 MOD <meta> <num>Calculate result of meta mod num and store result in the
     variable of the first argument.

     Example:

           MOD VARN 10; WRITELN %VARN%
     => 9

 MUL <meta> <num>Multiply a variable with a number and store result in the
     variable of the first argument.

     Example:

           MUL VARN 100; WRITELN %VARN%
     => 9900

 NOTIFY <text>Display message window.

     Example:

           NOTIFY "Hello World!"

 OPENFILE <filename> <mode>Open ASCII file (mode= r,w,a).

     Example:

           OPENFILE "data.lst" "a"
      opens file 'data.lst' in write append mode.

 PRINT <text>Same as WRITELN

 PUTFILE <text>Write text to an ASCII file opened with OPENFILE

 QUOTE <newquote>Change quotation character (")

 REDIALDial last number again.

 REQUEST <title> <opt1> [<opt2> [<opt3]]Display requester with options.

     Example:

           REQUEST "Are you sure?" "Yes" "No"

 RESPOND <text1> <text2>Send <text2> if <text1> is received (only during DELAY
     or WAIT commands). A maximum of 32 RESPOND commands can be active
     simultaneously. <text1> must not contain carriage returns or line feeds.
     RESPOND <text1> "" cancells any previous RESPONSE commands for <text1>.
     See SCRIPT\SAMPLE directory for an example about RESPOND.

 RESTIMERReset the timer on the status line.

 RETURNReturn from subroutine call (see CALL)

 RTRIM <meta>Remove trailing blanks from variable (see LTRIM).

     Example:

           RTRIM VAR1

 SEND <text>Send text to modem.

     Example:

           SEND "JOE USER^M"

 SENDBRKSend a modem break

 SENDKEY <number>Send text from macro key (1 ... 20)

 SETA <meta> <text> [<pos> [<length>]]Create or overwrite ASCII variable with
     text. Positive <pos> is counted from the left side of <text>, negative
     <pos> is taken from the right.

     Example:


             SETA V1 "Hello World"
             SETA V2 "Hello World" +4
             SETA V3 "Hello World" -3
             SETA V4 "Hello World" +2 3
             WRITE "%V1%, %V2%, %V3%, %V4%"

     OUTPUT: Hello World, lo World, rld, llo.

 SETN <meta> <num>Create or overwrite numerical variable with value

 SETEMU 1|2|3Set emulation (1=ANSI, 2=VT102, 3=TTY).

     Example:

           SETEMU 1

 SETTIMER <hh:mm:ss>Set timer to given time

 SHELL <command>Execute a program via 'CMD.EXE /C <command>'.

     Example:

           SHELL "DEL FILE.TMP"

 SUB <meta> <num>Subtract a number from a variable.

     Example:

           SUB VARN 50; WRITELN %VARN%
     => 49

 TIMEOUT <sec>Set timeout for WAIT (see WAIT, WAITLINE, IFBRK, IFNBRK).

     Example:

           TIMEOUT 60

 UPLOAD {X[K]|Y|Z} <file>Start upload.

     Example:

           UPLOAD XK "ZOC.ZIP"
      uploads ZOC.ZIP with Xmodem protocol and 1K blocksize.

 UPPER <meta>Convert variable to uppercase (see LOWER)

 WAIT <text>Wait for the given text (see WAITLINE, TIMEOUT, IFBRK, IFNBRK)

     Example:

           WAIT "Password"

 WAITLINEWait for the next non empty line of text (use WAIT "^M" to wait for
     the next line, no matter if empty or not). (See WAIT, TIMEOUT, IFBRK,
     IFNBRK).

     Example:

           WAITLINE

 WRITE <text>Write text to screen

 WRITELN <text>Write text to screen, add newline

 Note 1: Recognition of commands and system variables is case insensitive, but
     user defined variables are case sensitive.

 Note 2: Metas (=variables) are written between percent signs (like in DOS
     batch files). If a name of a meta is not recognized, the whole expression
     remains as is, that is if you write WRITE "%ABC%" and ABC does not exists
     ZOC prints just '%ABC%'.

 Note 3: Each line of code is processed in two steps. First all variables are
     replaced with their value. Second, the parser collects arguments and
     passes them to the commands. Arguments are delimited by TAB or Space,
     arguments containing TAB or Space must be enclosed by single or double
     quotes.

     The following commands are legal:

      SETA "string1" "Hello World"

      SETA string1 "Hello World"

      SETA string2 Hello

      WRITE "%string2%"

      WRITE %string2%

     The following commands are not legal:

      WRITE %string1%

      SETA string1 Hello World

     As a rule of thumb it is a good idea to include all <text> arguments in
     quotes, while it is generally safe and easier to read to leave arguments

 Note 4:Many functions (such as OPENFILE, REQUEST, GETFILE deliver error codes
     like (##ERROR##, ##CANCEL##, ##EOF##, ...) in %lastline%.

 Program part for the examples

             SETA VAR1 "Hello  "
             SETA VAR2 "Hell"
             SETN VARN 99
             SETN VARN2 10
          :Label
             WRITELN "%VAR1%"
             COMPA "%VAR1%" WITH "%VAR2%"
             COMPA  %VARN% WITH 100
             COMPN  %VARN% WITH %VARN2%


‚ïê‚ïê‚ïê 13. Other topics (common questions, future versions, ...) ‚ïê‚ïê‚ïê


                      Common problems, questions and answers
                              Lesser known functions
                         About this version (known bugs)
                              About future versions
                          Where to get current versions
                               The meaning of 'ZOC'
                              Contacting the author


‚ïê‚ïê‚ïê 13.1. Common problems, questions and answers ‚ïê‚ïê‚ïê

 Where do I get the current version of ZOC?
    see  availability

 How do I register, what does ZOC cost?
    see  how to order

 I get an error message that PHONEBOOK/Help is not found
    Set the 'Working Directory' in the ZOC icon to the directory where you put
    ZOC.

 How can I set ZOC to tone dialing
    Change the modem options and set the dial code to 'ATDT'.

 My modem works properly with other terminal software but not with ZOC
    Try using the same modem initialisation as in the other terminal package.
    Or store that modem configuration into the non volatile memory of the modem
    (generally done with AT&W) and use ATZ as initialisation string for ZOC.

 No characters appear after connecting to a BBS
    You use a secured transmission and the modem waits to get an ok signal from
    the computer which does not come. Turn on RTS/CTS in Options, Serial.

 Downloads generally work fine, but uploads of large files fail
    Probably you are using a high speed modem but have RTS/CTS disabled. For
    high speed transmission both, the modem and ZOC, need to be configured to
    use RTS/CTS handshake.

 ZOC turns NumLock on and off
    It's not a bug, it's a feature. ZOC uses the NumLock LED for VT102
    application key pad.  You can turn this off using Options, Emulation.

 The STANDARD options are not used at startup
    Maybe you unpacked ZOC without preserving pathnames. The STANDARD file must
    be in the .\OPTIONS subdirectory.

 Whenever I leave the program I get a 'carrier detect' warning
    Maybe your modem is configured to have the CD signal always on. Set it to
    match the CD state (maybe AT&C1) or set the CD signal to 'invalid' in the
    serial options.

 The phone book does not start the script
    You need to enter the path as well as the script name, eg. SCRIPT\DIALBBS.

 The phone book does not load the options file
    You need to enter the path as well as the options file name, eg.
    OPTIONS\VTOPTS.

 I miss a full screen mode
    There is no full screen mode available, the size of the window is limited
    by the font size and the number of rows/columns of the main window.
    However, you can set ZOC almost to full screen by selecting a larger font
    and more rows/columns.

 How can I change the number of rows/colums of the window?
    see  ZOC startup

 How do I select another com port?
    see  ZOC startup

 Is there a way to change the font or the colors of the terminal window?
    You can change the font size and color of the terminal window in
    (Options,Window), but not the font.


‚ïê‚ïê‚ïê 13.2. Lesser known functions. ‚ïê‚ïê‚ïê

This section contains a list of helpful features that you might have missed so
far.

 Printed Manual

    If you select the Print button from the help window, OS/2 will print the
    help file nicely formatted on your local printer.

 Toolbar

    When you click the toolbar icons with the right mouse button you will get
    an explanation in the title bar.

 Chat Mode

    ZOC has a chat mode, which you can switch on/off by pressing Alt+C or which
    you can map to the state of the Scroll-Lock key (options, terminal).

 Clipboard support

    When you move the mouse across the terminal window while holdin a mouse
    button depressed you will select text that is put into the clipboard when
    you release the mouse button. Left mouse button gives you stream mode
    selection, right button gives you block selection.

    If you hold the Ctrl key pressed while doing this, the text will be added
    to the clipboard instead of overwriting it.

 Quoting from the clipboard

    When you hold the Shift key pressed while selecting the Clipboard,
    Send-Quoted funtion (from menu, shortcut or toolbar) you will get smart
    quoting, no matter what mode you selected in the options notebook. So you
    might want to delselect smart quoting in the options and select it on the
    fly with the shift key when you need it.

 Phone book selection

    You can dial any combination of entries to be dialled from the phone book
    when you press the Ctrl key while selecting them.

 Changing the time between dialling attempts

    If you find the default time of 30 seconds between XDIAL attempts to
    connect to a bbs too short, you can either add 'WAIT=xx' to the autologin
    field of a phone book entry or modify the XDIAL script in the SCRIPTS
    directory (line 34: 'ifequ setn waittime 30');


‚ïê‚ïê‚ïê 13.3. About this version (known bugs) ‚ïê‚ïê‚ïê

ZOC is (as you already know) a terminal package. It evolved from an Amiga
program that was called AmigaCall (in Germany) or Mindlink (in the U.S.A.).

The Amiga sources, which had developed into some sort of swamp, have been
redesigned and are now shiny and new and ready for the future. All in all,
porting wasn't just a quick hack.

ZOC is shareware. It is for evaluation and it is complete. However, there is
one (and only one) small  nag

Known Bugs:none.


‚ïê‚ïê‚ïê 13.4. About future versions ‚ïê‚ïê‚ïê

Looking into the future is never easy, so  do not take this too literally

For future versions (don't look for V2.0 before September) I plan to implement
the following features:

     1.x
    Some smaller changes (nothing revolutionary), bug fixes.

     2.x
    Drag+Drop and WPS support, Phone book redesign and PM style XDIAL and
    QUEDIAL, REXX support

 TO DO
    The following is a list of features that were already requested by users.
    It it not clear when I implement them.

    * user defined toolbar

    * search command for capture

    * logging of file transfers

    * translation tables

    * multiple init and dial strings


‚ïê‚ïê‚ïê 13.5. Where to get current versions ‚ïê‚ïê‚ïê

Current versions of ZOC will be available from the following sources.

 ZOC Infobbs
    The ZOC information BBS is a simple system (in english) where you can get
    information, download the current version of ZOC and leave mail for me.

    The number is (011)+49+911+9933662 (or 0911 9933662 from Germany). Login as
    'ZOC'. Calling Germany is not as expensive as you might expect, download of
    a version of ZOC should cost not more than $3 from the U.S. (calling with
    14.400 bps).

     Compuserve
    All version with non trivial changes will be available on Compuserve's
    OS2SHARE forum. Browse for keyword 'ZOC'.

 Local BBSs/ftp
    ZOC will make its way around. Check your local bbs or ftp (eg.
    ftp.cdrom.com) site for files called 'ZOC*.ZIP'


‚ïê‚ïê‚ïê 13.6. The meaning of 'ZOC' ‚ïê‚ïê‚ïê

The Hitchhikers Guide to the Galaxy might describe ZOC as followed:

 zoc (v), to zoc means communicating with other people through the means of
extremely sophisticated hard- and software (sophisticated at least from the
viewpoint of the ape-descended inhabitants of an extremely unimportant blue
planet in an even lesser important part of the galaxy who think that W*****s is
a pretty neat piece of software).